home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 39 / Amiga Format CD39 (1999-04-13)(Future Publishing)(GB)[!][issue 1999-05].iso / -seriously_amiga- / graphics / ripley / ripley.readme < prev    next >
Text File  |  1999-03-02  |  5KB  |  195 lines
  1. Short:    mpeg video player 68k/powerup, including source
  2. Author:   Frank Pagels, Timm S. Mueller
  3. Uploader: Frank Pagels (copper@informatik.uni-rostock.de)
  4. Type:     gfx/show
  5. Version:  0.4
  6. Requires: Kickstart 3.0 (v39), 68020
  7.  
  8.  
  9.   originally released at the 'Bockbier & Hackbraten'
  10.   neoscientific summer conference
  11.  
  12.  
  13. introduction
  14. ----------------------
  15.  
  16.   Ripley is a mpeg video player, featuring
  17.   
  18.   - PPC support
  19.   - PicassoIV PiP support
  20.   - freely scalable window
  21.   - runs on any screenmode, including OCS/ECS/AGA, HAM, chunky,
  22.     hi- and truecolor, runs on any public screen, can open
  23.     an own public screen
  24.   - asynchronous I/O (68k version only)
  25.   - the framerate is by default determined by the video,
  26.     and may be optionally set to an user-defined value
  27.   - the brightness can be adjusted
  28.   - supports saving of the whole animation's frames
  29.   - can save 'snapshots' of single frames while running
  30.  
  31.  
  32. todo
  33. ----------------------
  34.  
  35.   - faster replay
  36.   
  37.   - dithering on 8bit displays
  38.   
  39.   - slide forward/backward 
  40.   
  41.   - mpeg2 videos are not replayed correctly yet.
  42.  
  43.   - sound. we're considering an mpeg sound replay via
  44.     mpega.library.
  45.   
  46.   - HAM is fully supported in high quality,
  47.     but rendering is very slow.
  48.  
  49.  
  50.  
  51. usage
  52. ----------------------
  53.  
  54.   commandline arguments:
  55.  
  56.   FILE/A         - mpeg video file
  57.   GREY/S         - use greyscale
  58.   PIP/S          - use PicassoIV PiP window
  59.   SNAP/S         - snap window to the video's dimensions
  60.   LOOP/S         - loop
  61.   FPS/S          - display FPS counter
  62.   FRAMERATE/N    - set framerate [fps]
  63.   IGNOREFPS/S    - play at maximum speed
  64.   CUSTOMSCREEN/S - open an own (public) screen
  65.   SCRWIDTH/N     - screen width [pixels]
  66.   SCRHEIGHT/N    - screen height [rows]
  67.   DEPTH/N        - screen depth [1...24]
  68.   HAM/S          - open HAM screen (DEPTH required)
  69.   PUBSCREEN/K    - name of a pubscreen to open upon
  70.   BORDERLESS/S   - open a borderless window
  71.   WINSIZE        - window size mode;
  72.                    SMALL, HALF, LARGE, VISIBLE or FULL
  73.   SAVE/K         - filename template for saving, e.g. 
  74.                    pic%d or pic%d%c for fieldwise storage
  75.   SAVEFORMAT/K   - file-format for saving, PPM or YUV
  76.   TASKPRI/N      - task priority
  77.  
  78.  
  79.   Ripley can be controlled via keyboard.
  80.  
  81.   t      - toggle frames-per-second counter
  82.   g      - toggle grey/color mode
  83.   space  - freeze display
  84.   s      - snapshot the current frame in PPM format
  85.   +      - increase brightness
  86.   -      - decrease brightness
  87.   #      - reset brightness
  88.   0      - limit to the video's frame rate
  89.   1      - replay with 5 frames per second
  90.   2      - replay with 10 frames per second
  91.   3      - replay with 15 frames per second
  92.   4      - replay with 20 frames per second
  93.   5      - replay with 25 frames per second
  94.   6      - replay with 30 frames per second
  95.   7      - replay with 50 frames per second
  96.   8      - replay with 60 frames per second
  97.   9      - replay with maximum speed
  98.   
  99.   F1     - snap window to the animation's size
  100.   F2     - small window
  101.   F3     - half window
  102.   F4     - large window
  103.   F5     - visible window
  104.   F6     - full window
  105.  
  106.  
  107. requirements
  108. --------------------------------------
  109.  
  110.   - os3.0 (v39)
  111.   - 68020 or PPC (powerup)
  112.   - guigfx.library (dev/misc/GuiGFXLib.lha)
  113.   - render.library (dev/misc/RenderLib.lha)
  114.   - asyncio.library (dev/c/AsyncIO.lha. required in the 68k version only.)
  115.  
  116.   optional:
  117.  
  118.   - picasso96api.library
  119.   - cybergraphics.library
  120.  
  121.  
  122.  
  123. technical details
  124. ----------------------
  125.  
  126.  
  127. general:
  128.  
  129. - ripley is (hopefully) still in full compliance to ISO
  130. specifications. we tried to not sacrifice precision for
  131. speed.
  132.  
  133. - mpeg2 is currently not fully supported. we have
  134. restructured major parts in the display section, and we
  135. haven't found the time yet to integrate the second
  136. half-frame into the display logic.
  137.  
  138. - we have not seen ripley crashing from corrupt animations
  139. so far. ripley sometimes exits without closing the window
  140. when data is heavily corrupted, and we will try to fix this.
  141.  
  142.  
  143.  
  144. 68k version:
  145.  
  146. - all assembler optimizations intend to maximum performance
  147. on 68060 processors. some parts use arithmetics where tables
  148. would be faster on lower processors. ripley is yet fully
  149. compatible to all 68020++ systems with FPU.
  150.  
  151. - ripley uses a 18bit tabular colorpace conversion,
  152. providing almost the same performance as simple greyscale
  153. rendering. the output slightly suffers from limited
  154. precision, though. note: colorspace conversion table
  155. requires 1mb (!) of memory.
  156.  
  157.  
  158.  
  159. authors
  160. ----------------------
  161.  
  162.   Frank 'Copper' Pagels / Defect Softworks
  163.     (Initiator,PPC version, PiP features)
  164.     copper@informatik.uni-rostock.de
  165.  
  166.   Bifat / TEK neoscientists
  167.     (68k version)
  168.     timm.mueller@darmstadt.netsurf.de
  169.   
  170.   support site:
  171.     http://come.to/neoscientists
  172.  
  173.  
  174. history
  175. ----------------------
  176.  
  177.   0.4 - 68k version: some speed increase.
  178.         ripley now uses a pervert buffer size (1 mb)
  179.         for high-speed colorspace conversion.
  180.       - brightness correction is now implemented in
  181.         color mode.
  182.       - 68k version: removed visual artifacts resulting
  183.         from idct bugs.
  184.       - size of the load buffer slightly enlarged.
  185.       - the space key can be used to pause.
  186.       - CTRL_C has been implemented.
  187.       - snapshot implemented
  188.   
  189.   0.3 - added ppc version, screen handling, keyboard
  190.         shortcuts, saving, borderless window, HAM support
  191.   
  192.   0.2 - initial beta release at the
  193.         'bockbier & hackbraten'
  194.         neoscientific summer conference
  195.